SaferPluginFormatHelpers

La classe SaferPluginFormatHelpers fournit des méthodes d'aide pour le formatage des données.

Méthodes

surface(int $surface): string

public static function surface(int $surface): string

Description

Formate une valeur de surface en une représentation sous forme de chaîne.

Paramètres

  • int $surface : La valeur de la surface à formater, en centièmes de hectare.

Retour

  • string : La valeur de surface formatée sous la forme "X ha Y a Z ca".

Exemple

$formattedSurface = SaferPluginFormatHelpers::surface(123456); // '12 ha 34 a 56 ca'

price(float $price): string

public static function price(float $price): string

Description

Formate une valeur de prix en une représentation sous forme de chaîne.

Paramètres

  • float $price : La valeur du prix à formater.

Retour

  • string : La valeur du prix formatée avec des espaces pour les milliers et un espace avant le symbole euro.

Exemple

$formattedPrice = SaferPluginFormatHelpers::price(1234567.89); // '1 234 568 €'

percent(float $percent, int $decimals = 1, bool $showSign = false): string

public static function percent(float $percent, int $decimals = 1, bool $showSign = false): string

Description

Formate une valeur en pourcentage en une représentation sous forme de chaîne.

Paramètres

  • float $percent : La valeur en pourcentage à formater.
  • int $decimals : Le nombre de décimales à afficher (par défaut : 1).
  • bool $showSign : Si true, un signe plus est affiché pour les valeurs positives (par défaut : false).

Retour

  • string : La valeur en pourcentage formatée.

Exemple

$formattedPercent = SaferPluginFormatHelpers::percent(12.3456); // '12,3 %'
$formattedPercentWithSign = SaferPluginFormatHelpers::percent(12.3456, 1, true); // '+12,3 %'

percentFromRate(float $rate, int $decimals = 1, bool $showSign = false): string

public static function percentFromRate(float $rate, int $decimals = 1, bool $showSign = false): string

Description

Formate une valeur de taux en pourcentage en une représentation sous forme de chaîne.

Paramètres

  • float $rate : La valeur du taux à formater (exprimée en proportion, par exemple 0.15 pour 15%).
  • int $decimals : Le nombre de décimales à afficher (par défaut : 1).
  • bool $showSign : Si true, un signe plus est affiché pour les valeurs positives (par défaut : false).

Retour

  • string : La valeur du taux formatée en pourcentage.

Exemple

$formattedPercentFromRate = SaferPluginFormatHelpers::percentFromRate(0.1234); // '12,3 %'
$formattedPercentFromRateWithSign = SaferPluginFormatHelpers::percentFromRate(0.1234, 1, true); // '+12,3 %'

Remarques

  • Les méthodes percent et percentFromRate utilisent la virgule comme séparateur décimal et l'espace comme séparateur des milliers.
  • La méthode surface divise la valeur de surface en hectares, ares et centiares pour un affichage plus lisible.
  • La méthode price formate le prix avec des espaces pour les milliers et ajoute un espace avant le symbole de l'euro.